Cream of the Crop 1

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 1 / Cream of the Crop 1.iso / EDITOR / WED15.ARJ / WE.DOC < prev next >

Wrap

Text File | 1991-11-11 | 57KB | 1,458 lines

Wilkes Editor for DOS Copyright 1991 by Roger E. Wilkes Member of ASP - Association of Shareware Professionals Distributed by: Wilkes Software, inc. 5231 Longwood Drive Memphis, TN 38134 Table of Contents License.................................................... i Warranty................................................... ii Registration Fee........................................... iii Files...................................................... 1 Help....................................................... 2 How WE Works............................................... 3 Control Keys............................................... 6 Cursor Movement Keys................................... 6 CURSOR TO BEGINNING OF NEXT LINE................... 6 CURSOR TO NEXT SENTENCE............................ 7 CURSOR TO NEXT WORD................................ 8 CURSOR TO PREVIOUS WORD............................ 9 CURSOR TO PREVIOUS SENTENCE........................ 10 CURSOR TO END OF LINE.............................. 11 CURSOR TO BEGINNING OF LINE........................ 12 CURSOR TO END OF DOCUMENT.......................... 13 CURSOR TO TOP OF DOCUMENT.......................... 14 CURSOR UP.......................................... 15 PAGE UP............................................ 16 CURSOR DOWN........................................ 17 PAGE DOWN.......................................... 18 CURSOR LEFT........................................ 19 CURSOR RIGHT....................................... 20 CURSOR TO NEXT TAB POSITION........................ 21 BACKSPACE.......................................... 22 File Controls.......................................... 23 OPEN NEW FILE - ADD TO ACTIVE LIST................. 23 GO TO THE NEXT ACTIVE FILE......................... 24 SAVE FILE - EXIT EDITOR OR NEXT FILE............... 25 ESCAPE FROM WHERE YOU CURRENTLY ARE................ 26 PERSONAL FUNCTIONS FILE............................ 27 Deleting............................................... 27 DELETE CHARACTER................................... 27 DELETE WORD........................................ 28 DELETE LINE........................................ 29 Text Block Control..................................... 30 BEGIN BLOCK........................................ 30 END BLOCK.......................................... 31 DELETE BLOCK....................................... 32 COPY BLOCK......................................... 33 Searching and Replacing................................ 34 SET SEARCH LITERAL................................. 34 SEARCH FOR LITERAL ENTERED......................... 35 SEARCH BACKWARD FOR LITERAL ENTERED................ 36 SET LITERAL TO CHANGE TO........................... 37 SEARCH FOR AND CHANGE LITERAL...................... 38 Table of Contents (cont.) SEARCH BACKWARD AND CHANGE LITERAL................. 39 Help................................................... 40 Set Video Attributes................................... 41 Save Current Controls.................................. 42 Other Controls......................................... 43 UNDO LINE OR BLOCK................................. 43 CHANGE CONTROL CHARACTERS.......................... 44 INSERT MODE (ON/OFF)............................... 45 BLANKS AT END OF LINE (ON/OFF)..................... 46 SET SEARCH CASE SENSITIVE (ON/OFF)................. 47 SET TAB LENGTH..................................... 48 i LICENSE ------- Wilkes Editor, version 1.5, is being distributed under the "shareware" or user supported concept. This software is NOT free software. The use or reproduction of this software outside of the limits specified in this license agreement is prohibited. Non-registered users are granted a limited license to use this software for a period not to exceed thirty days. During this period they should test and evaluate the software to determine if it will meet their needs. The use of this software beyond this limited time period requires registration. Non-registered users are not allowed to distribute this software without the express written permission of Wilkes Software inc. The only exceptions to this distribution restriction are SYSOPS of electronic bulletin boards and distributors of public domain and user supported software. SYSOPS and software distributors must abide by the copying restrictions specified below. Registered users are granted the right to use Wilkes Editor on only one computer at any time. Site licensing agreements are available for businesses, corporations, and government agencies. Registered users are also granted the right to copy and distribute Wilkes Editor subject to the following conditions. Wilkes Editor must be copied in its original unmodified form. All of the files must be included in the copy. Wilkes Editor may not be distributed in conjunction with any other product without the express written consent of Wilkes Software inc. ii WARRANTY -------- Wilkes Software makes no warranty of any kind, express or implied, including without limitation, any warranties of merchantability and or fitness for a particular purpose. Wilkes Software shall not be liable for any damages, whether direct, indirect, special or consequential arising from a failure of this software to operate in the manner desired by the user. Wilkes Software shall not be liable for any damage to data or property which may be caused directly or indirectly by use of the program. IN NO EVENT WILL Wilkes Software BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. iii REGISTRATION FEES ----------------- The registration fee for Wilkes Editor, version 1.5, is only $30.00, with quantity discount for 10 or more copies to $20.00/copy. Government and Education registration fee is only $27.00, with quantity discount for 10 or more copies to $17.00/copy. You may fill out and return the registration page below or register on-line at (901)377-5608. Enter "s" from the main menu and select the software you wish to register. Future updates of the site license copy are provided as follows. The first update is free. All others $10.00. Prices are for a titled master copy and cover all charges including shipping. Licensees will be informed when updates become available and given the option to update at will. There is NO penalty for skipping updates. iv If you should require assistance in the use of the Wilkes Editor, you may call the WSI BBS at (901)377-5608. If you like this software please let me know. If you have enhancements you would like to see in this software, please let me know those also. If you have complaints about the way the Wilkes Editor functions I would even like to hear those. The following is a registration form. In addition to the licensing use, I will also use this information to correlate requests for additional functionality and for Wilkes Software mailing list purpose (only by Wilkes Software). When Wilkes Software offers other software into the shareware system in the future, information will be sent to registered users of the Wilkes Editor. If you register a non-current version, I will send the current version to you. v to: Wilkes Software, inc. 5231 Longwood Drive Memphis, TN 38134 Name (first) ____________________ (last) ____________________ Title ___________________________________ Company ___________________________________ Address ___________________________________ ___________________________________ City _________________________ State ___ Zip code _______ Where software obtained: ________________________________________ Version of Wilkes Editor: 1.5 System: ____________________ DOS Version: _____ Media: __ 5 1/4 (360) __ 3 1/2 (720) __ 5 1/4 (1.2) __ 3 1/2 (1.44) Phone: (____) ____ - _____ If Gov./Ed. please specify: _____________________________________ COST: $30/copy - 10 + copies $20/copy Gov/Ed $27/copy - 10 + copies $17/copy Tennessee Residents: sales tax is 7.75% # copies _________ x your price: ____________ + TN sales tax __________ = Total _________________ METHOD OF PAYMENT: VISA/MASTERCARD/CHECK: __________ V/MC account #: ___________________________ Expiration Date: _________ Signature: __________________________________________________ 1 Files: ------ In WED15.EXE You should have the files WE.DOC, WE.EXE, FUNCTION.CTL, DETAB.DOC and DETAB.EXE Edit Files: ----------- You can have a maximum of 20 text files concurrently being edited. The cumulative file sizes may be as much as the disk you have will allow. The DOS version of the Wilkes Editor uses its own virtual memory to store the text files being edited and requires disk of at least 48,000 bytes and will use as much disk as required as virtual memory. All virtual memory must be on disk so disk must be available. A 10K file will not fit into 10K of virtual memory, because there is memory control overhead. Editor Control File: -------------------- This file will be created the first time WE.EXE runs. The location of this file is controlled by the environment variable EDTCTL (short for Editor Control). The environment variable can be set in "autoexec.bat". The DOS instruction to be placed inside "autoexec.bat" is SET EDTCTL=<name of directory> There should be no spaces before or after the "=". The file "EDITOR.CTL" will be created in the specified directory and the "DISKMEM" virtual memory file will be placed in this directory also. If the environment variable EDTCTL is not set, the file "EDITOR.CTL" will be created in the current directory as will the "DISKMEM" virtual memory file. When the EDITOR.CTL file is created, it will contain all of the default control keys, video attributes and initial control settings. EDITOR.CTL contains the control keys, video attributes and various control initialization settings. Any changes you make to control keys, video attributes, etc. will be kept in this file (if you save the changes). 1A Personal Functions File: ------------------------ The file FUNCTION.CTL contains macros, data types and ANSI "C" functions are listed by header file in this personal function file. It is editable to update to your personal needs. This file, if you wish to use it, should be placed in the directory defined by the environment variable 'EDTCTL'. See 'Editor Control File' above for a discussion of the environment variable 'EDTCTL'. This file is like any other file except that it is added to the working file list via the 'ctl+f' control key. The FUNCTION.CTL file can be used for any purpose: If you use this editor to write letters the FUNCTION.CTL file might contain the name and address of your correspondents. If you use some other language than "C", place pertinent information in the FUNCTION.CTL file. 2 Help: ----- Help is obtained to display the control keys current settings by striking the F1 key. While the Help screen is displayed, you may use the control keys PgUp, PgDn, up and down arrow keys and the begin and end of document keys. The ESC key will get you out of the help screen and return you to the text file you were in prior to asking for HELP. The control keys are listed in the left hand column, and may represent the depression of multiple keys. If a "+" is shown in this column, you must simultaneously depress the key before and after the "+". The abreviations shown are: enter - enter key ctl - control (Ctrl) key end - End key home - Home key pgup - page up (PgUp) key pgdn - page down (PgDn) key curu - cursor up (up arrow) key curd - cursor down (down arrow) key curr - cursor right (right arrow) key curl - cursor left (left arrow) key tab - Tab (right) key fn - where n is the function key number sfn - where n is the shifted function key number afn - where n is the function key number to depress with the Alt key ins - insert (Ins) key del - delete (Del) key backspace - backspace (Backspace) key esc - escape (Esc) key All other keys shown are the actual keys. For instance, "ctl+t" would be accomplished by holding down the Ctrl key and striking the "t" key. Note that both keys must be simultaneously down to accomplish "ctl+t". 3 How WE Works: ------------- When you run WE, you must name the text file you wish to edit on the command line: WE letter.bob Note: The name of the text file is a DOS file name (see DOS reference manual for file names) and may be no longer than 39 characters maximum with full pathing. Example: WE c:\mailbox\outbound\letter.bob This restriction will also apply to files added to the working list of text files within WE. This restriction is created by the space alloted to the file name on the status (bottom) line of the WE display screen. There is room for only 39 characters for the file name. The Display Screen: ------------------- The screen is broken up into 3 areas. The first area is where text is displayed and updated. The second area is the Control line, where you will enter information to control the functioning of WE. The Control line is located just below the Text area. The third area of the screen is the status line at the bottom of the screen, containing the current location within the text file (CUR <line>,<column>), the insert status, whether ON or OFF, a reminder that a tab character will be shown as up to 4 spaces, which text file is currently being displayed (TXn - where n is 0-9) and the name of the file currently displayed. Display Lines: -------------- A given line of text cannot be longer than 254 characters. Since only 80 characters of any given line can be shown on the screen at one time, the cursor control keys (right arrow, end, etc.) can be used to view any unshown portion of a line. If you move the cursor outside the first 80 characters of a line, the entire screen will shift right or left to display the same columns for all lines. 4 The cursor will stay within columns 70-80 while the columns being displayed are outside the first 80 columns. Don't be alarmed when everything on the screen shifts left or right. You can always get the screen back to the first 80 columns of each line by hitting the "home" key. If someone has modified the home key, you can find the control key for "home" with "help". If someone has changed the location of the "help" key, you can either locate that person, play with the keyboard or return to DOS and reset the environment variable EDTCTL to point to a different directory or delete the "EDITOR.CTL" file. The last option should be used only sparingly if there are more than one persons using WE on the same machine. Cursor Positioning: ------------------- During finds, changes, block insertions, undo's, etc. WE will attempt to maintain the cursor close to the center of the screen. When you perform one of the functions which uses this method of positioning the text on the screen, don't be startled. The reason for this positioning is to be able to see text prior to and after the located, inserted, manipulated text. User Friendly: -------------- Every attempt has been made with WE to strike a proper balance between "don't slow the user down" and "don't let the user hurt himself". There are only a few places which stop and question the motives of the user. Hopefully, these few instances represent the places where you would wish to be questioned. If you attempt to edit a file which does not exist you will be asked if you really wish to create the file. If you attempt to Esc a file which has had modifications made to it, you will be asked if you really wish to drop the changes you have made. The attempt was made to have a user seductive, rather than a user friendly Editor. 5 Ascii Graphics: --------------- WE will allow most Ascii Graphic characters - where they do not conflict with control keys. As the Esc character is used heavily with "ANSI.SYS" graphics, a special character is set aside to introduce the ESC character into text, while having the Esc key always represent the escape control key. The escape control key is the only non-modifiable control key. The method of entering an ESC character into a text file is to depress the Alt key and enter 1 then 9 on the numeric key pad, then lifting the Alt key (i.e. keep the Alt key depressed while entering both the 1 and the 9 keys). Ascii Graphic characters must be entered in the same way as the special ESC. Keep the Alt key depressed while entering the number representing the Ascii Graphic character. Tab Character: -------------- WE does not use tab characters internally but will accept text files which use them. Since WE acts as if a tab stop were set at every 4th column (i.e. columns 4, 8, 12, 16, 20, etc.) the tab characters will be translated to spaces in order to move to these tab stops. If you have text files containing tab characters, you may wish to run "DETAB.EXE" on them before using WE. The DETAB program will translate tab characters to the desired number of spaces. 6 Control Keys: ------------- Cursor Movement Keys: --------------------- enter: CURSOR TO BEGINNING OF NEXT LINE --------------------------------------- The action of the enter key works in one of two ways, depending on the current setting of "insert". 1) Insert ON - The current line will be broken into two lines consisting of the portion of the line prior to the cursor position and the portion of the line under the cursor to the end of the line. The second line will be positioned at the beginning of the newly introduced line. 2) Insert OFF - The cursor will move to the beginning of the next line. If you are on the last line of the text you will receive a message on the control line to the effect that you are on the last line of text with insert OFF. The enter key is the only way to introduce new lines of text other than BLOCK COPY and UNDO. In order to insert a new line (open line) into the text, place the cursor at the beginning of the line just below the position of the open line and hit the enter key. You can also simply key in the new line text and hit the enter key to break the line at the position of the cursor. 7 ctl+t: CURSOR TO NEXT SENTENCE ------------------------------ This control will move the cursor to the position in the text to the position of the first text following one of the sentence termination characters: . (period) ! (exclamation point) ? (question mark) This control was introduced to facilitate the writing of correspondence - for programmers who write letters with their editor. see CURSOR TO PREVIOUS SENTENCE 8 ctl+w: CURSOR TO NEXT WORD -------------------------- The CURSOR TO NEXT WORD will move the cursor down in the text to the first non-blank character following one or more blank characters. A word is considered to be any contiguous set of non-blanks. see CURSOR TO PREVIOUS WORD 9 alt+w: CURSOR TO PREVIOUS WORD ------------------------------ The CURSOR TO PREVIOUS WORD will move the cursor up in the text to the beginning of the current word or to the previous word if the cursor is positioned to the immediate right of the beginning of the line or to the immediate right of a space. A word is considered to be any contiguous set of non-blanks. see CURSOR TO NEXT WORD 10 alt+t: CURSOR TO PREVIOUS SENTENCE ---------------------------------- The CURSOR TO PREVIOUS SENTENCE will move the cursor to the beginning of the current sentence or to the beginning of the previous sentence, where a sentence is terminated by the characters: . (period) ! (exclamation point) ? (question mark) If any characters other than blanks are between the cursor and the prior sentence terminator the cursor will be moved to the beginning of the current sentence. see CURSOR TO NEXT SENTENCE 11 end: CURSOR TO END OF LINE -------------------------- The CURSOR TO END OF LINE control will move the cursor to the end of the current line. If the line is longer than 80 characters, all lines displayed will be shifted to correspond to the line the cursor is on. see CURSOR TO BEGINNING OF LINE 12 home: CURSOR TO BEGINNING OF LINE --------------------------------- The CURSOR TO BEGINNING OF LINE control will position the cursor to the first column of the current line. If the lines currently displayed do not show text from the beginning of the line, all lines of the display will shift right to display from the first column. see CURSOR TO END OF LINE 13 ctl+pgdn: CURSOR TO END OF DOCUMENT ----------------------------------- The CURSOR TO END OF DOCUMENT will move the cursor to the last line of the text. see CURSOR TO TOP OF DOCUMENT 14 ctl+pgup: CURSOR TO TOP OF DOCUMENT ----------------------------------- The CURSOR TO TOP OF DOCUMENT will move the cursor to the first line of text. see CURSOR TO END OF DOCUMENT 15 curu: CURSOR UP --------------- CURSOR UP moves the cursor to the previous line of text, if there is a previous line of text. If the cursor is already at the first line of text, there will be no action. The column in which the cursor resides is unchanged. see CURSOR DOWN, CURSOR RIGHT and CURSOR LEFT 16 pgup: PAGE UP ------------- The PAGE UP control will bring the previous 23 lines of text onto the screen. If there are less than 23 lines of text prior to the first line currently being displayed, the displayed lines will begin with the first line of text in the document. see PAGE DOWN 17 curd: CURSOR DOWN ----------------- The CURSOR DOWN control will position the cursor to the next line, in the same column it is presently in. If the cursor is on the last line of the document, no action will be taken. see CURSOR UP, CURSOR RIGHT and CURSOR LEFT 18 pgdn: PAGE DOWN --------------- The PAGE DOWN control will bring the next 23 lines of text onto the screen. If the number of lines of text after the line on which the cursor resides is less than 23, then the last lines of text will be displayed. see PAGE UP 19 curl: CURSOR LEFT ----------------- The CURSOR LEFT control moves the cursor one position to the left. If the cursor is at the first column of the line, no action will be taken. see CURSOR UP, CURSOR DOWN and CURSOR RIGHT 20 curr: CURSOR RIGHT ------------------ The CURSOR RIGHT control moves the cursor one position to the right. If the cursor moves beyond the first 80 columns of the line, all lines displayed will shift left to keep the cursor within columns 70-80. If the cursor attempts to move beyond the maximum length of a line, a message to that effect will be displayed on the control line. see CURSOR UP, CURSOR DOWN and CURSOR LEFT 21 tab: CURSOR TO NEXT TAB POSITION -------------------------------- There are automatic tab stops at every 4th column of the line. Striking the TAB key will move the cursor to the next tab stop and insert spaces into the text sufficient to correspond to the way the text looks on the screen. 22 backspace: BACKSPACE -------------------- The BACKSPACE control will act in one of two ways, depending on the current setting of the INS (insert) control: 1) Insert ON - The cursor will move left one position, deleting the character which was in that position, and the text following the cursor on the line will be shifted left one position. 2) Insert OFF - The cursor will move left one position, and delete the character in the column to which it moves, but the text under and after the cursor for the line will remain in position. 23 File Controls: -------------- f4: OPEN NEW FILE - ADD TO ACTIVE LIST -------------------------------------- WE can work with up to 20 active files at a time. In order to add a new file to the active files list, hit the F4 key. You will be asked for the file name on the control line. Enter up to 39 characters for the DOS file name and hit the enter key. The new file will be brought to the screen. If a requested file does not exist, you will be asked, on the control line, if you wish to create the file. If you answer "n", the cursor will move back to the text position it was on prior to F4 having been struck. If you answer "y", you will be presented with a blank text area in which to enter text. If you attempt to excede the maximum of 20 active files, you will be notified on the control line. see GO TO THE NEXT ACTIVE FILE, SET VIDEO ATTRIBUTES, SAVE FILE - EXIT EDITOR OR NEXT FILE and ESCAPE FROM WHERE YOU CURRENTLY ARE 24 af4: GO TO THE NEXT ACTIVE FILE ------------------------------- The name of the current active text file is displayed on the status line, and just in front of the file name is an indicator of which of the 20 active text files you are currently working in. If you have multiple copies of the same text file active the TXn indicator on the status line will help distinguish the text file iteration. You may also set the video attributes separately for each of the 20 active files in order to further distinguish which text file is being worked in. see OPEN NEW FILE - ADD TO ACTIVE LIST, SET VIDEO ATTRIBUTES, SAVE FILE - EXIT EDITOR OR NEXT FILE and ESCAPE FROM WHERE YOU CURRENTLY ARE 25 cf1: SAVE FILE - EXIT EDITOR OR NEXT FILE ----------------------------------------- Saving a file to disk is accomplished by holding the control key down and hitting the F1 key. The text file will be written to disk. The text file already on disk by the same name will be renamed to have a file name extension of .BAK. If the file name of the text file contains a file name of .BAK, it will be renamed to have a file name extension of .BK2. If a file is saved which has had no modifications made to it, a message to that effect will be displayed on the control line, or if there are no more active files, it will be displayed upon return to DOS. When a text file has been saved to disk, there will be an additional open position in which you may add another text file to the active list. see OPEN NEW FILE - ADD TO ACTIVE LIST, GO TO THE NEXT ACTIVE FILE, SET VIDEO ATTRIBUTES, and ESCAPE FROM WHERE YOU CURRENTLY ARE 26 esc: ESCAPE FROM WHERE YOU CURRENTLY ARE ---------------------------------------- The reason ESC was included in the file controls is that this is where it has its strongest effect. If the cursor is within the text area of the screen, the ESC will drop the text without saving it to disk. If you have made changes to the text a prompt will appear on the control line: Drop Changes (y/n)? If you wish to drop the changes made to this text answer "y" and the text will go away. If you have made changes which you don't wish to destroy, answer "n" and the ESC will be forgotten and you will be returned to the text area of the same text file on which you were working. Note that this prompt is the only prompt from which you cannot escape. You must answer "y" or "n". The ESC control is the only control which cannot be modified. ESC will generally escape you from whereever you are. For instance, if you are entering a new file name to be added to the active list, and decide not to add a new file at this time, hitting the ESC key will move the cursor back to the text area of the screen for you to continue to work in the current text file. see OPEN NEW FILE - ADD TO ACTIVE LIST, GO TO THE NEXT ACTIVE FILE, SET VIDEO ATTRIBUTES and SAVE FILE - EXIT EDITOR OR NEXT FILE 27 ctl+f: PERSONAL FUNCTIONS FILE ------------------------------ The PERSONAL FUNCTIONS FILE is to have rapid access to a personal file. WED15.EXE contains a file called FUNCTION.CTL consisting of a list of macros, data types and function calls in standard ANSI "C". The PERSONAL FUNCTIONS FILE will be editable just like any other file when brought into the working file list. The FUNCTION.CTL file should be placed in the directory pointed to by the environment variable EDTCTL. Deleting: --------- del: DELETE CHARACTER --------------------- The DELETE CHARACTER control will delete the character under the cursor and move the text to the right of the cursor one position to the left to close up the deleted character position. see DELETE WORD, DELETE LINE and DELETE BLOCK 28 sf6: DELETE WORD ---------------- The DELETE WORD control will delete the word under the cursor and draw the text following the deleted word left to close up the gap created by deleting the word. If the cursor is sitting on a blank, no action will be taken. see DELETE CHARACTER, DELETE LINE and DELETE BLOCK 29 f6: DELETE LINE --------------- The DELETE LINE control will take one of two actions depending on where the cursor is on the line: 1) Cursor at first position of the line - The entire line will be deleted and following text lines shifted up to fill in the gap created by the deleted line. 2) Cursor not at first position of the line - The text under and following the cursor on the line will be deleted. The line will remain in place. see DELETE CHARACTER, DELETE WORD and DELETE BLOCK 30 Text Block Control: ------------------------ ctl+home: BEGIN BLOCK --------------------- The BEGIN BLOCK control marks the position of the cursor as the beginning of a block. If any changes are made to the text (other than cursor movement), the begin block marking will be terminated. The purpose of the begin block marking is to subsequently mark the end of the block, in order to copy the contents of the block or to delete the block of text. 31 ctl+end: END BLOCK ------------------ The END BLOCK control marks the end of a text block. When the end of the block is marked, the entire block is copied to a new memory location, in order to preserve the contents of the block if the block is subsequently deleted. This allows us to copy the block of text into a new location even after the block has been deleted from its original location. 32 ctl+d: DELETE BLOCK --------------------- The DELETE BLOCK control will delete the marked block from the text file it was defined for. If you mark a block and change text files, you will not be allowed to delete the block until you return to the text file for which the block was originally defined. This marks a difference between the OS/2 editor and the DOS version of the editor. DOS will not take the ctl+del control used with OS/2 and even in the DOS compatibility box under OS/2. 33 ctl+b: COPY BLOCK ----------------- The COPY BLOCK control allows you to copy a block of information from one point in the text to another point. This includes the ability to copy the block from one text file into another text file. 34 Searching and Replacing: ------------------------ alt+l: SET SEARCH LITERAL ------------------------- When you enter the SET SEARCH LITERAL control you will be prompted on the control line for the search literal. Enter the text to be searched for at the cursor, then hit the enter key. The cursor will be returned to the text area. The search literal will be retained until you either change the search literal by performing the SET SEARCH LITERAL control again or exit WE. see SEARCH FOR LITERAL ENTERED, SEARCH BACKWARD FOR LITERAL ENTERED, SEARCH FOR AND CHANGE LITERAL and SEARCH BACKWARD AND CHANGE LITERAL 35 alt+f: SEARCH FOR LITERAL ENTERED --------------------------------- The literal entered refers to the literal entered during the SET SEARCH LITERAL control. The search's case sensitivity may be altered by the SET SEARCH CASE SENSITIVITY (ON/OFF) control. See this control below. When a matching literal is found, the cursor will be placed at the end of the literal, in order not to find that same literal on successive searches. This also allows the search backward to find this literal first. see SET SEARCH LITERAL and SET SEARCH CASE SENSITIVITY (ON/OFF) 36 alt+g: SEARCH BACKWARD FOR LITERAL ENTERED ------------------------------------------ Similar to SEARCH FOR LITERAL ENTERED control, except that the literal is searched for backward through the text. see SET SEARCH LITERAL, SEARCH FOR LITERAL ENTERED and SET SEARCH CASE SENSITIVITY (ON/OFF) 37 alt+h: SET LITERAL TO CHANGE TO ------------------------------- The SET LITERAL TO CHANGE TO control lets you specify a literal to be substituted for the literal specified in the SET SEARCH LITERAL. As this literal is specified independent of the SEARCH LITERAL, you may change the SEARCH LITERAL several times, changing several literals to the same LITERAL TO CHANGE TO. see SEARCH FOR AND CHANGE LITERAL, SEARCH BACKWARD AND CHANGE LITERAL 38 alt+j: SEARCH FOR AND CHANGE LITERAL ------------------------------------ The SEARCH FOR AND CHANGE LITERAL control uses the SEARCH FOR LITERAL ENTERED routine to locate the literal to be replaced. see SET LITERAL TO CHANGE TO, SET SEARCH LITERAL, SEARCH FOR LITERAL ENTERED and SET SEARCH CASE SENSITIVITY (ON/OFF) 39 alt+k: SEARCH BACKWARD AND CHANGE LITERAL ----------------------------------------- The SEARCH BACKWARD AND CHANGE LITERAL control uses the SEARCH BACKWARD FOR LITERAL ENTERED routine to locate the literal to be replaced. see SET LITERAL TO CHANGE TO, SET SEARCH LITERAL, SEARCH BACKWARD FOR LITERAL ENTERED and SET SEARCH CASE SENSITIVITY (ON/OFF) 40 Help: ----- help: HELP ---------- Help is similar to a separate text file which displays two columns: 1) The current key(s) to access the control and 2) An explaination of the control. These columns cannot be modified directly, but will change if you modify the control keys with CHANGE CONTROL KEYS discussed below. The help display is an exhaustive display of the control keys and their meanings. 41 Set Video Attributes: --------------------- ctl+v: SET VIDEO ATTRIBUTES --------------------------- The video attributes are kept separately for each of the 20 possible active text files. Each text file's video attributes consists of three attributes - corresponding to the screen areas: 1) Text area - where you enter and modify text 2) Control line - where you receive messages and answer prompts (questions) 3) Status line - at the bottom of the screen You may modify only one or two of the areas video attributes if you wish by escaping (ESC) after making the modifications you wish. The video attributes are modified only for the text file area you are currently working in. The video attributes will correspond to the "n" of status lines "TXn". 42 Save Current Controls: ---------------------- ctl+y: SAVE THE CURRENT CONTROLS -------------------------------- The EDITOR.CTL file contains all of the control key settings, video attributes and control initialization settings. If you have made changes to any of the above and wish to save them, depress the Ctrl key and hit "y". This will write the current controls into the EDITOR.CTL file. Since WE will create a new EDITOR.CTL file if it is missing, you may move back to the default control settings by deleting the EDITOR.CTL file from the DOS prompt. 43 Other Controls: --------------- ctl+u: UNDO LINE OR BLOCK ------------------------- When a line is updated (the update takes place when you move the cursor from the modified line) it is stored in its original form. In this way we can recover text which has been modified, back to its original contents. The UNDO will undo a line or block at a time. The scope of the undo is by individual text file. If you wish to undo changes made to several files, you will have to go to each text file and undo them individually. Undo will only undo while you are within WE. When WE is exited, all information pertaining to undo is forgotten. The maximum number of lines/blocks which may be undone is 100 per text file. If you need to go back further than this, you may need to escape the text file and drop all changes. Note that the undo will be stored until you undo or it is pushed off the undo stack (100 entries). If you undo a line/block, modify a line, and undo the modifications to that line, the other entries on the undo stack are still available to be undone. 44 f2: CHANGE CONTROL CHARACTERS ----------------------------- If you wish to change the key(s) associated with a particular control, this control will allow you to make that change. If, for instance, you wish to have the OPEN NEW FILE control to be placed on the F9 key rather than the F4 key (default), strike F2. The control line will contain "Enter CURRENT Control Character". Hit the control character to be changed - F4. The current control setting for F4 will be displayed and a prompt for the control key(s) to be the new key(s) for opening a new file. Enter F9. The control key change is accomplished. There are several control key combinations with the Ctrl key + another key and Alt key + another key. You will not be allowed to change a control to a key which is already being used as a control key. 45 ins: INSERT MODE (ON/OFF) ------------------------- The insert mode current setting is displayed on the status line at the bottom of the screen. The insert mode setting will alter the way the enter and backspace keys work. If insert mode is OFF, you will be overtyping text. If insert mode is ON, you will be inserting text at the position of the cursor. 46 alt+1: BLANKS AT END OF LINE (ON/OFF) ------------------------------------- The BLANKS AT END OF LINE control determines whether any terminating blanks will be saved or not. This action takes place when the line is updated, and applies only at the line update level. If you set this control to ON, modify a line and move the cursor to a new line, any blanks at the end of the line will be retained. If you set this control to OFF, modify a line and move the cursor to a new line, blanks at the end of the updated line will be removed. This control does not display, but you can find out if it is on or off by testing it. When you move to the end of the line with the END control, you are moving to the position just past the end of the line and if there are blanks at the end of the line, the cursor will be to the right of these blanks. 47 af1: SET SEARCH CASE SENSITIVE (ON/OFF) --------------------------------------- This control determines whether upper case and lower case will match on a search. It is defaulted to on, but may be changed and saved. Example: If we are searching for "screen" and case sensitive is ON, we would not get a match on text containing "Screen". If case sensitive is off "screen" would match "Screen". The case sensitive control determines matches on both searches and search and replace. As this control is not displayed, you may determine if it is on or off by testing it. 48 ctl+a: SET TAB LENGTH --------------------- The SET TAB LENGTH control will display the message "Enter One Digit TAB Setting: " on the control line under the text area. Enter a single digit 1-9 as the number of columns represented by a tab.